Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Editing Movies

AddMovieSelection

The AddMovieSelection function adds one or more tracks to a movie. This function scales the source movie so that it fits into the destination selection. If the current selection in the destination movie has a 0 duration, the Movie Toolbox adds the segment at the beginning of the current selection.

pascal void AddMovieSelection (Movie theMovie, Movie src); 

theMovie

Specifies the destination movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

src

Specifies the source movie for this operation. The AddMovieSelection function adds the tracks from this movie to the destination movie. The function adds these tracks at the time specified by the current selection in the destination movie.

DESCRIPTION

The AddMovieSelection function is similar to PasteMovieSelection, which is described in the previous section. However, the PasteMovieSelection function inserts empty space into a movie's existing tracks and then adds the new track data. The AddMovieSelection function does not insert empty space into the existing tracks. This function simply adds the tracks in parallel from the source movie to the destination movie. This can be useful for adding a track to an existing movie, such as adding sound to a silent movie.

The Movie Toolbox removes any empty tracks from the destination movie after the
add operation.

If you have assigned a progress function to the destination movie, the Movie Toolbox calls that progress function during long add operations. (For details, see "Progress Functions" beginning on page 2-333.)

The entire source movie is used regardless of the selection in the source movie.

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
progressProcAborted	-2019	Your progress function returned an error

Memory Manager errors